Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Color Profile Messages

GXSetFormatProfile

QuickDraw GX sends the GXSetFormatProfile message to change the current color profile for a format object. Your override of the GXSetFormatProfile message must match the following formal declaration:

OSErr MySetFormatProfile (gxFormat theFormat,
            gxColorProfile oldProfile, gxColorProfile newProfile);

theFormat

The format object.

oldProfile

The profile that has been associated with the format object.

newProfile

The profile to add to the list of profiles for a format object.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

You can override the GXSetFormatProfile message to change the current profile for a format object, to replace an existing profile that is associated with the format object, or to remove a profile from the list of color profiles that are associated with the format object.

The values of the oldProfile and newProfile parameters define what happens in response to this message, as shown in Table 4-3.

The actions of the GXSetFormatProfile message

Value of oldProfile	Value of newProfile	Action taken
nil	nil	None
Valid	nil	oldProfile is deleted from the list of profiles associated with the format object
nil	Valid	newProfile is added to the list of profiles for the format object and becomes the current profile
Valid	Valid	oldProfile is deleted from the list of profiles, newProfile is added, and newProfile becomes the current profile for the format object

The default implementation of this message modifies the list of profiles that are associated with the format object, as shown in Table 4-3.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The GXSetFormatProfile function is described in Inside Macintosh: QuickDraw GX Printing.

Color matching, color profiles, and color profile resources are described in Inside Macintosh: Advanced Color Imaging.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help